@opentelemetry/tracing

OpenTelemetry Tracing SDK

The tracing module contains the foundation for all tracing SDKs of opentelemetry-js.

Used standalone, this module provides methods for manual instrumentation of code, offering full control over span creation for client-side JavaScript (browser) and Node.js.

It does not provide automated instrumentation of known libraries, context propagation for asynchronous invocations or distributed-context out-of-the-box.

For automated instrumentation for Node.js, please see @opentelemetry/node.

Installation

npm install --save @opentelemetry/api
npm install --save @opentelemetry/tracing

Usage

const opentelemetry = require('@opentelemetry/api');
const { BasicTracerProvider } = require('@opentelemetry/tracing');

// To start a trace, you first need to initialize the Tracer provider.
// NOTE: The default OpenTelemetry tracer provider does not record any tracing information.
//       Registering a working tracer provider allows the API methods to record traces.
new BasicTracerProvider().register();

// To create a span in a trace, we used the global singleton tracer to start a new span.
const span = opentelemetry.trace.getTracer('default').startSpan('foo');

// Set a span attribute
span.setAttribute('key', 'value');

// We must end the spans so they become available for exporting.
span.end();

Example

See examples/basic-tracer-node for an end-to-end example, including exporting created spans.

Useful links

• For more information on OpenTelemetry, visit: https://opentelemetry.io/
• For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js
• For help or feedback on this project, join us on gitter

License

Apache 2.0 - See LICENSE for more information.

Changelog

0.5.2

Released 2020-03-27

:rocket: (Enhancement)

• opentelemetry-exporter-prometheus, opentelemetry-metrics
  • #893 Metrics: Add lastUpdateTimestamp associated with point (@mayurkale22)
• opentelemetry-tracing
  • #896 Do not export empty span lists (@dyladan)
• opentelemetry-api, opentelemetry-tracing
  • #889 feat: start a root span with spanOptions.parent = null (@dyladan)

:bug: (Bug Fix)

• opentelemetry-core, opentelemetry-propagator-jaeger
  • #904 fix: add type checking in propagators (@dyladan)
• opentelemetry-context-base, opentelemetry-core, opentelemetry-plugin-document-load, opentelemetry-plugin-user-interaction, opentelemetry-web
  • #906 chore: fixing documentation for web tracer provider, fixing examples … (@obecny)
• Other
  • #884 chore: fixing main package.json version (@obecny)

:books: (Refine Doc)

• opentelemetry-context-base, opentelemetry-core, opentelemetry-plugin-document-load, opentelemetry-plugin-user-interaction, opentelemetry-web
  • #906 chore: fixing documentation for web tracer provider, fixing examples … (@obecny)

Committers: 4

• Bartlomiej Obecny (@obecny)
• Daniel Dyla (@dyladan)
• Mark Robert Henderson (@aphelionz)
• Mayur Kale (@mayurkale22)